home *** CD-ROM | disk | FTP | other *** search
/ Image Compendium / Image Compendium.iso / viewer / dos / snapvs.arc / SNAPVGA.DOC < prev    next >
Encoding:
Text File  |  1988-08-01  |  11.6 KB  |  338 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              SNAPVGA
  12.  
  13.                                 by
  14.  
  15.                           Richard Q. Fox
  16.  
  17.                       Version 1.0  July 1988
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27. SNAPVGA is a Shareware program that displays any GIF graphic file
  28. in VGA format. All pictures captured by GIF and displayed through
  29. SNAPVGA will automatically have the correct height to width ratio
  30. and will appear in true perspective. The entire picture is in
  31. view at one time. 
  32.                         TABLE OF CONTENTS
  33.  
  34.  
  35. SHAREWARE. . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  36.  
  37. SNAPVGA FEATURES . . . . . . . . . . . . . . . . . . . . . . .  4
  38.  
  39. COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  40.          Introduction . . . . . . . . . . . . . . . . . . . . .  5
  41.          Directory. . . . . . . . . . . . . . . . . . . . . . .  5
  42.          Load . . . . . . . . . . . . . . . . . . . . . . . . .  6
  43.          Save . . . . . . . . . . . . . . . . . . . . . . . . .  6
  44.          Change Color . . . . . . . . . . . . . . . . . . . . .  7
  45.          Print. . . . . . . . . . . . . . . . . . . . . . . . .  8
  46.          Exit . . . . . . . . . . . . . . . . . . . . . . . . .  8
  47.  
  48. DOS COMMAND LINE ENTRY . . . . . . . . . . . . . . . . . . . .  9
  49.  
  50. PRINTERS . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  51.  
  52. REVISION HISTORY . . . . . . . . . . . . . . . . . . . . . . . 10
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. SNAPVGA for the IBM PC is Copyright 1988 (c) by Richard Q. Fox.
  60. All Rights Reserved. User Supported Software. For a non-
  61. commercial license, send $10.00 to:
  62.  
  63.                           Richard Q. Fox
  64.                         1364 Campbell St.
  65.                         Orlando, FL 32806
  66.  
  67.                     CompuServe ID: 72356,242
  68.  
  69. GIF and 'Graphics Interchange Format' are trademarks (tm) of
  70. CompuServe Incorporated, an H&R Block Company. Portions of this
  71. program Copyright 1986, 1987 New Dimension Software.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78. SHAREWARE
  79.  
  80. SNAPVGA is user supported software. SNAPVGA for the IBM PC is
  81. made available for a free ten day trial period. If you find this
  82. program useful, you may license the program for non-commercial
  83. use on one machine by sending $10.00 to:
  84.  
  85.                          Richard Q. Fox
  86.                         1364 Campbell St.
  87.                         Orlando, FL 32806
  88.  
  89. SNAPVGA may be licensed for commercial use on up to 10 computers
  90. at a single site or set of contiguous sites for $50.00. A
  91. commercial site is defined as a business or individual seeking to
  92. make a profit by selling SNAPVGA or incorporating this program in
  93. another program.
  94.  
  95. Clubs, schools, universities and other organizations may license
  96. SNAPVGA for $25.00 per 6 copies.
  97.  
  98. All other rights are reserved.
  99.  
  100. SNAPVGA may not be changed or modified in any way except by the
  101. author. SNAPVGA may be freely distributed for the ten day trial
  102. period as long as it remains in its complete form. Regardless of
  103. how the copy is obtained, it is requested that all users comply
  104. with the licensing agreement.
  105.  
  106. All licensing registrations will be promptly acknowledged. All
  107. licensees will receive prompt notification of product revisions
  108. and will be able to purchase updates at a nominal fee.
  109.  
  110. All warranties are disclaimed, including damage to hardware
  111. and/or software from use of this product. 
  112.  
  113. SNAPVGA FEATURES
  114.  
  115. SNAPVGA has four main capabilities. One, SNAPVGA automatically
  116. displays a GIF picture in VGA format on an IBM PC or clone. Many
  117. GIF pictures were originally in MAC, Atari, or some other format
  118. and previously required scrolling to view them on the IBM.
  119. SNAPVGA compresses or expands the picture while retaining true
  120. proportions, allowing the user to view the entire picture at
  121. once.
  122.  
  123. SNAPVGA's second important feature allows the user to alter the
  124. brightness and contrast of the picture without having to move to
  125. another graphics program.  The picture can then be saved to disk
  126. or printed or both.
  127.  
  128. Finally, SNAPVGA can make a hard copy printout of any GIF file on
  129. the OKIMATE 20 or STAR NX-1000 Rainbow printer. The printout has
  130. the correct aspect ratio, is in 256 colors, and is 8" x 10" in
  131. landscape format. SNAPVGA is issued in 2 versions. One support
  132. the OKIMATE 20. The other supports the STAR NX-1000 Rainbow.
  133. Otherwise, the two versions are identical.
  134.  
  135. SNAPVGA COMMANDS
  136.  
  137. SNAPVGA is a straight forward, menu driven program that is easy
  138. to use. When first accessed, SNAPVGA places a blue menu on screen
  139. with the selected command highlighted in red. The commands are:
  140.     Directory 
  141.     Introduction
  142.     Load a Picture
  143.     Change Colors 
  144.     Print Picture 
  145.     Save a Picture
  146.     Exit 
  147.  
  148.  
  149. Commands are accessed by using the up and down arrows. When the
  150. desired command is highlighted in red, press carriage return to
  151. access that command. Alternately, the first letter of each
  152. command may be pressed, or the space bar may be pressed.
  153.  
  154.  
  155.  
  156. The Introduction gives a brief synopsis of the program and how to
  157. use it.
  158.  
  159.  
  160.  
  161. The Directory is the way to go if the user wants to load a
  162. picture but isn't sure of the name, doesn't know what disk it is
  163. on, or can't remember the spelling. 
  164.  
  165. The Directory function prompts the user for the disk path. If the
  166. source is the current path, pressing return will list the
  167. contents of that directory. Typing the disk drive and
  168. subdirectory followed by a carriage return will also bring in the
  169. contents of the disk. 
  170.  
  171. Loading pictures via the Directory allows the user to search
  172. several disks to locate the picture without having to first find
  173. the picture, then load SNAPVGA, then load the picture. This time
  174. saving feature permits the handling of many pictures at one
  175. sitting and eliminates the need to search for pictures before
  176. using the program. 
  177.  
  178. The Directory sorts up to 240 GIF file names alphabetically. The
  179. window shows 60 file names. Use the cursor arrow keys to scroll
  180. through the full list of up to 240 file names. Even better, press
  181. the FIRST LETTER of the file name, to jump the cursor to the area
  182. of the window that contains files starting with that letter.
  183.  
  184. Press ENTER to display the picture, or press ESCAPE to return to
  185. the Main Menu. The ESCAPE key may also be used to abort back to
  186. the Main Menu while the picture is loading.
  187.  
  188. While the Directory is being displayed, you may use the F9 key to
  189. find out the specifications of the highlighted file in the
  190. directory list. A small window will pop up, showing the height,
  191. width, and color resolution of the GIF file. A typical file might
  192. by reported as 320 x 200, in 256 colors. You may select the file
  193. while the specification window is showing, by pressing the
  194. "ENTER" key, or you may use the cursor arrows to move on to other
  195. files in the directory.
  196.  
  197.  
  198.  
  199. The Load command allows direct loading of pictures from any
  200. drive. The load command first prompts for the path, followed by a
  201. carriage return. The user is then prompted for the file name and
  202. the file extender. If no file extender is entered, an extender of
  203. GIF is assumed. Many users are adding their own personal
  204. extenders to GIF files to facilitate sorting. Extenders such as
  205. .trv (for travel) for example are recognized by the Load command
  206. of SNAPVGA as long as the file is in GIF format. While the
  207. picture is loading, the ESCAPE key may be pressed to abort back
  208. to the Main Menu.
  209.  
  210.  
  211.  
  212.  
  213. The Save commands operates the same as the Load command. The user
  214. is asked to specify the path, the drive, the file name and the
  215. extender. If the specified name already exists, pressing carriage
  216. return will save the file.
  217.  
  218.  
  219.  
  220.  
  221. WARNING: WHEN SAVING A PICTURE WITH SNAPVGA, IT IS BEST TO SAVE
  222. THE FILE UNDER A NEW NAME TO AVOID OVERWRITING THE ORIGINAL GIF
  223. FILE. ALL FILES WRITTEN BY SNAPVGA ARE 320x200 by 256 COLORS,
  224. REGARDLESS OF THE FORMAT OF THE ORIGINAL FILE.
  225.  
  226. Change Color allows the user to change the brightness and
  227. contract of any picture. The Function keys provide the control
  228. over the brightness and contrast.
  229.  
  230.     F1 is the HELP key. Press it at any time for a summary of
  231.      instructions.
  232.  
  233.     F2 restores the original palette of the picture. If you do
  234.      not like the changes you are making, you can press F2 to
  235.      UNDO them. This key may be pressed as often as desired.
  236.  
  237.     F3 Decreases the contrast. 
  238.     F4 Increases the contrast.
  239.     Press these keys as often as needed, until you like the
  240.      result. The amount of change made by each depression of a
  241.      key can be controlled. The NUMBER keys 1 through 9 select
  242.      the step size. "1" is the smallest step size. "9" is the
  243.      largest step size. "5" is automatically selected as the
  244.      default step size, when you start the program. Press a
  245.      NUMBER key, and then press F3 and or F4 repeatedly.
  246.  
  247.     F5 Decreases brightness.
  248.     F6 Increases brightness.
  249.     The operation of these keys is the same as that for F3 / F4.
  250.  
  251.     F9 Recalls a memorized palette setting.
  252.     F10 Saves a memorized palette setting.
  253.     While you are experimenting with the brightness and contrast
  254.      settings, you can memorize the current setting by pressing
  255.      F10. A tone confirms that the setting is memorized. You can
  256.      then press any other function keys, to continue
  257.      experimenting. When you want to recall the memorized
  258.      setting, press F9. You can press F9 repeatedly, without
  259.      erasing its setting. The only key that changes the memorized
  260.      setting is F10.
  261.     
  262. Once the picture is to the user's satisfaction, pressing ESC,
  263. SPACE, or ENTER returns SNAPVGA to the main menu. At this point,
  264. the new picture can be saved. The picture may be altered and
  265. saved as many times as the user wishes. Simply save the altered
  266. picture under a new name to avoid destroying the original.
  267.  
  268.  
  269. The Print command prints the picture on a OKIMATE 20 or STAR NX-
  270. 1000 Rainbow. There are two versions of SNAPVGA, one for each
  271. printer. The printed picture is 8" x 10" and is in landscape
  272. format. The best paper for printing has a waxed, high gloss
  273. surface and can be obtained through office supply stores at about
  274. 10 cents a sheet. This paper gives dense, overlapping color
  275. saturation without streaks and gaps.
  276.  
  277.  
  278.  
  279.  Exit allows the user to leave SNAPVGA.
  280.  
  281. DOS COMMAND LINE ENTRY
  282.  
  283. Snapvga may be initiated with a DOS command line which contains
  284. SNAPVGA and one of the following:
  285.  
  286.     The name of the file to display 
  287.         If the file exists, it is loaded and displayed
  288.           immediately.
  289.  
  290.     The name of the directory to use
  291.         If the directory exists, Snapvga goes immediately to
  292.           its Directory function, with all file names in that
  293.           Directory listed in a window.
  294.  
  295.     Nothing
  296.         Snapvga starts with an Title Screen, and a menu of
  297.           choices.
  298.  
  299. Drive names and path names may be included in the argument passed
  300. to Snapvga. A file extender of .GIF is assumed, if no extender is
  301. present for a file name.
  302.  
  303.     Examples:
  304.  
  305.         SNAPVGA a:car.gif                    (Loads and displays
  306.                                              the file)
  307.  
  308.         SNAPVGA c:\gif\bird.gif              (Loads and displays
  309.                                              the file)
  310.  
  311.         SNAPVGA c:\gif                       (Shows the
  312.                                              directory)
  313.  
  314.         SNAPVGA                              (Shows the title
  315.                                              screen, ready for
  316.                                              further commands)
  317.  
  318. PRINTERS
  319.  
  320. SNAPVGA supports several printers. Each version of the program
  321. supports one printer. This version of the program is written for
  322. the OKIMATE 20 or STAR NX-1000 Rainbow.  SNAPVGA uses enhanced
  323. programming which gives OKIMATE 20 and STAR NX-1000 Rainbow
  324. prints crisp, solid color and emulates the screen colors as
  325. closely as possible. 
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332. REVISION HISTORY
  333.  
  334. Revision 1.0 is a new release.
  335.  
  336.  
  337.  
  338. Richard Q. Fox   July 31, 1988